home *** CD-ROM | disk | FTP | other *** search
/ Programmer Power Tools / Programmer Power Tools.iso / c / btoa.arc / BTOA.MAN < prev   
Text File  |  1989-01-23  |  3KB  |  133 lines
  1.  
  2.  
  3. BTOA(1)             UNIX Programmer's Manual              BTOA(1)
  4.  
  5.  
  6. NAME
  7.      btoa, atob, tarmail, untarmail - encode/decode binary to
  8.      printable ASCII
  9.  
  10. SYNOPSIS
  11.      btoa
  12.      atob
  13.      tarmail who subject files ...
  14.      untarmail [ file ]
  15.  
  16. DESCRIPTION
  17.      Btoa is a filter that reads anything from the standard
  18.      input, and encodes it into printable ASCII on the standard
  19.      output.  It also attaches a header and checksum information
  20.      used by the reverse filter atob to find the start of the
  21.      data and to check integrity.
  22.  
  23.      Atob reads an encoded file, strips off any leading and
  24.      trailing lines added by mailers, and recreates a copy of the
  25.      original file on the standard output.  Atob gives NO output
  26.      (and exits with an error message) if its input is garbage or
  27.      the checksums do not check.
  28.  
  29.      Tarmail is a shell script that tar's up all the given files,
  30.      pipes them through compress, btoa, and mails them to the
  31.      given person with the given subject phrase.  For example:
  32.  
  33.           tarmail ralph "here it is ralph" foo.c a.out
  34.  
  35.      Will package up files "foo.c" and "a.out" and mail them to
  36.      "ralph" using subject "here it is ralph".  Notice the quotes
  37.      on the subject.  They are necessary to make it one argument
  38.      to the shell.
  39.  
  40.      Tarmail with no args will print a short message reminding
  41.      you what the required args are.  When the mail is received
  42.      at the other end, that person should use mail to save the
  43.      message in some temporary file name (say "xx").  Then saying
  44.      "untarmail xx" will decode the message and untar it. Untar-
  45.      mail can also be used as a filter.  By using tarmail, binary
  46.      files and entire directory structures can be easily
  47.      transmitted between machines.  Naturally, you should under-
  48.      stand what tar itself does before you use tarmail.
  49.  
  50.      Other uses:
  51.  
  52.      compress < secrets | crypt | btoa | mail ralph
  53.  
  54.      will mail the encrypted contents of the file "secrets" to
  55.      ralph.  If ralph knows the encryption key, he can decode it
  56.      by saving the mail (say in "xx"), and then running:
  57.  
  58.      atob < xx | crypt | uncompress
  59.  
  60.  
  61.  
  62. Printed 1/20/89               local                             1
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. BTOA(1)             UNIX Programmer's Manual              BTOA(1)
  70.  
  71.  
  72.      (crypt requests the key from the terminal, and the "secrets"
  73.      come out on the terminal).
  74.  
  75. AUTHOR
  76.      Paul Rutter (modified by Joe Orost)
  77.  
  78. FEATURES
  79.      Btoa uses a compact base-85 encoding so that 4 bytes are
  80.      encoded into 5 characters (file is expanded by 25%).  As a
  81.      special case, 32-bit zero is encoded as one character.  This
  82.      encoding produces less output than uuencode(1).
  83.  
  84. SEE ALSO
  85.      compress(1), crypt(1), uuencode(1), mail(1)
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128. Printed 1/20/89               local                             2
  129.  
  130.  
  131.  
  132.  
  133.